home *** CD-ROM | disk | FTP | other *** search
/ CD Actual 22 / PC Actual CD 22.iso / linux / xfree86 / DOC / README.Linux < prev    next >
Encoding:
Text File  |  1998-01-07  |  11.2 KB  |  463 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.               Information for Linux Users
  11.  
  12.              Orest Zborowski, Dirk Hohndel
  13.  
  14.                  May 13, 1997
  15.  
  16.  
  17.  
  18. 1.  Linux versions on which XFree86 has been tested
  19.  
  20. XFree86 has been tested with Linux version 2.0.30. It should work with any ver-
  21. sion since 1.0 without change. The binaries and libraries are based on the
  22. 5.4.7 Elf C libraries, and the 1.7.14 dynamic linker ld.so. You will at least
  23. need the 5.2.x Elf C libraries to successfully use the servers.
  24.  
  25.  
  26. 2.  Backwards Compatibility
  27.  
  28. X11R6 is considered a major update from X11R5, so the shared libraries in
  29. XFree86 3.1 and later are not compatible with XFree86 2.1.1 and older
  30. libraries. To continue to run X11R5 applications, you must keep the old
  31. libraries somewhere on your machine. They can be moved from /usr/X386/lib else-
  32. where, but /etc/ld.so.conf must be updated.  All X11R5 applications should work
  33. with the X11R6 servers without problems.
  34.  
  35. X11R6.1 is yet another update to X11R6. While the minor number for some
  36. libraries has been increased to '1' it is believed to be fully compatible with
  37. X11R6 based applications.
  38.  
  39. X11R6.3 is yet another update to X11R6.1. While the minor number for some
  40. libraries has been increased to '3' it is believed to be fully compatible with
  41. X11R6 based applications.
  42.  
  43. Very old binaries (linked to XFree86-1.2, XFree86-1.3 or XFree86-2.0 libraries)
  44. will continue to work, but may need an explicit symlink from
  45. /lib/libX{11,t,aw}.so.3 to /usr/X386/lib/libX{11,t,aw}.so.3.
  46.  
  47.  
  48. 3.  Installing XFree86
  49.  
  50. Starting with version 3.0, XFree86 is installed in /usr/X11R6.    Each binary
  51. distribution of XFree86 3.X comes with a detailed installation document rele-
  52. vant to that release. The most up-to-date information is kept there, while this
  53. document describes basic features of XFree86 3.X on Linux and how to compile
  54. the sources.
  55.  
  56.  
  57. 4.  Running XFree86
  58.  
  59. XFree86 requires about 4mb of virtual memory to run, although having 8mb of RAM
  60. is probably the minimum comfortable configuration. A 387 coprocessor is helpful
  61. for 386 machines, although greater gains in interactive performance are
  62.  
  63.  
  64. Information for Linux Users
  65.  
  66.  
  67.  
  68.  
  69.  
  70. Information for Linux Users
  71.  
  72.  
  73.  
  74. obtained with an increase in physical memory.  Also, a faster graphics card,
  75. bus or RAM, will improve server performance.
  76.  
  77. After unpacking the tar files, you need to include /usr/X11R6/lib in
  78. /etc/ld.so.conf (where it should already be by default) or in your
  79. LD_LIBRARY_PATH environment variable. Also, the configuration file
  80. /etc/XF86Config or /usr/X11R6/lib/X11/XF86Config must be properly filled out
  81. based on the host setup. Ideally this is done using XF86Setup or (if for some
  82. reason this doesn't work) using xf86config. If you really insist in hand-creat-
  83. ing your config file use XF86Config.eg as a starting point and README.Config as
  84. guideline.  You may damage your hardware if you use a wrong XF86Config file, so
  85. read the docs, especially the man pages and the other README files in
  86. /usr/X11R6/lib/X11/doc.
  87.  
  88. XFree86 has the ability to perform VT switching to and from the X server. When
  89. first started, XFree86 will automatically locate the first available VT (one
  90. that hasn't been opened by any process), and run on that VT.  If there isn't
  91. one available, XFree86 will terminate with an error message.  The server can be
  92. run on a specific VT by using the ``vt<nn>'' option, where <nn> is the number
  93. of an available VT (starting from 1). If you don't have a free VT XFree86 can-
  94. not run. Normally you can simply disable one of the getty programs in
  95. /etc/inittab, but if this is not an option, you can increase the number of
  96. available VTs by increasing the value of NR_CONSOLES in include/linux/tty.h and
  97. recompiling the kernel.
  98.  
  99. Once running inside X, switching to another VT is accomplished by pressing
  100. Ctrl-Alt-<Fnn> where nn is the number of the VT to switch to.  To return to the
  101. server, press the proper key-combination that moves you back to the VT that
  102. XFree86 is using: by default, this is Alt-<Fmm>, where mm is the number of the
  103. VT the server is running on (this number is printed when the server is
  104. started).  Note that this is NOT the VT from which the server was started.
  105.  
  106. NOTE: you can redefine the text-mode keybindings with the `loadkeys' command
  107. found in the kbd-0.81.tar.gz archive (or a later version thereof).  With this,
  108. you can (for example) make Ctrl-Alt-<Fmm> work from text mode the same way it
  109. works under the XFree86 server.
  110.  
  111. When the server is exited, it will return to the original VT it was started
  112. from, unless it dies unexpectedly, when the switch must be done manually. There
  113. still seem to be weird combinations of graphic cards and motherboards that have
  114. problems to restore the textfont when returning from XFree86 to the text mode.
  115. In these cases using the runx script from the svgalib distribution might help.
  116.  
  117. The XFree86 server now queries the kernel to obtain the key binding in effect
  118. at startup. These bindings are either the default map in place when the kernel
  119. was compiled, or reloaded using the `loadkeys' utility. Not all keys are bound:
  120. kernel-specific, multiple keysym, and dead keys are not handled by the server.
  121. All others are translated to their X equivalents.  Note that the XFree86 server
  122. only allows for four modifier maps: unshifted, shifted, modeswitch unshifted
  123. and modeswitch shifted.  Depending on what the modeswitch key is (it is config-
  124. urable in your XF86Config and defaults to Alt), XFree86 will read those tables
  125. into its keymaps.  This means if you use certain keys, like left-Control, for
  126. Linux modeswitch, that will not be mappable to X.
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. Information for Linux Users
  137.  
  138.  
  139.  
  140. 5.  Installing Xdm, the display manager
  141.  
  142. Since xdm is dynamically linked, there's no issue on export restriction outside
  143. US for this binary distribution of xdm: it does not contain the DES encryption
  144. code. So it's now included in the bin package.
  145.  
  146. However the file xc/lib/Xdmcp/WrapHelp.c is not included in the XFree86-3.3
  147. source, so support for XDM-AUTHORIZATION-1 is not included here. You'll have to
  148. get WrapHelp.c and rebuild xdm after having set HasXdmAuth in xf86site.def.
  149.  
  150. The file is available within the US; for details see ftp.x.org:/pub/R6/xdm-
  151. auth/README.
  152.  
  153. To start the display manager, log in as root on the console and type: ``xdm
  154. -nodaemon''.
  155.  
  156. You can start xdm automatically on bootup by disabling the console getty and
  157. modifying /etc/inittab. Details about this setup depend on the Linux distribu-
  158. tion that you use, so check the documentation provided there.
  159.  
  160. The xdm binary provided should run with both shadow- and non-shadow password
  161. systems.
  162.  
  163.  
  164. 6.  xterm
  165.  
  166. The XFree86-3.3 binary release contains an xterm binary that has been linked
  167. statically against libtermcap. This was done to make sure that it will cor-
  168. rectly work with all distributions, regardless whether they rely on libtermcap
  169. or libncurses. Contrary to the xterm binaries in some beta version following
  170. XFree86-3.1.2, this binary does not rely on a recent libncurses being installed
  171. on your system.
  172.  
  173.  
  174. 7.  Input devices
  175.  
  176. XFree86 now support the dynamic loading of drivers for external input devices
  177. using the XInput extension. Currently supported devices are:
  178.  
  179.    o Joystick (xf86Jstk.so)
  180.  
  181.    o Wacom tablets (Wacom IV protocol only, xf86Wacom.so)
  182.  
  183.    o SummaSketch tablets (xf86Summa.so)
  184.  
  185.    o Elographics touchscreen (xf86Elo.so)
  186.  
  187. To use a specific device, add the line
  188.  
  189.      load "module"
  190.  
  191.  
  192. in the Module section of XF86Config, where module is the name of the .so file
  193. corresponding to your device.  You also need to set up a XInput section in
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. Information for Linux Users
  203.  
  204.  
  205.  
  206. XF86Config.  Refer to the XF86Config(5) man page for detailed configuration
  207. instructions.
  208.  
  209. You can then change the device used to drive the X pointer with the xset-
  210. pointer(1) command.
  211.  
  212. For joystick support, you'll need to install the joystick device driver in the
  213. kernel.
  214.  
  215. 7.1  Configuring PEX, XIE and GLX extensions
  216.  
  217. The PEX, XIE and GLX extensions are now supported as external modules.    If you
  218. want to have access to these extensions, add the following lines to the Module
  219. section of XF86Config:
  220.  
  221.     load    "pex5.so"
  222.     load    "xie.so"
  223.  
  224.  
  225. For GLX you need to get the appropriate GLX modules, first. They are, at this
  226. time, not part of the XFree86 distribution.
  227.  
  228.  
  229. 8.  Compiling XFree86
  230.  
  231. There are no special instructions required for compiling XFree86.  This version
  232. was compiled with gcc-2.7.2.1, the 5.4.7 Elf libraries and the 1.7.14 shared,
  233. dynamic linker ld.so.  The server has been compiled with -m486, which optimizes
  234. it for the 486 processor, but the binary will run on the 386 processor (there
  235. is a slight increase in binary size over using -m386, but no loss of perfor-
  236. mance).
  237.  
  238. All extensions and clients have been ported and tested. By default, the servers
  239. are compiled without any extra extensions (PEX, XIE, etc), but libraries for
  240. those extensions are always generated. They can be loaded at runtime, see the
  241. XFree86 man page for details. By modifying site.def, extra extensions can be
  242. compiled into the server.  Alternately, the link kit can be used to craft modi-
  243. fied servers.
  244.  
  245. The distribution is very large, but it is possible to compile XFree86 on a sin-
  246. gle 64mb partition, if the source tree is carefully trimmed (no manpages, PEX
  247. or large clients). Simply run ``make Makefiles'' to create the Makefiles, then
  248. stop the make and run each piece individually. It is not necessary to run
  249. ``make depend'' as well, which saves some space.  Having 150mb available makes
  250. compiling XFree86 a lot easier. You will need about 10mb of virtual memory to
  251. compile the entire server.
  252.  
  253. If an aout version of XFree86 is to be built and patches are applied which sig-
  254. nificantly change the libraries, modified jump_xxx files will be needed. Those
  255. can be generated according to instructions given in the DLL tools package, and
  256. will be made available as XFree86 patches.
  257.  
  258. The JUMP_xxx defines used to compile the X libraries can also be used to com-
  259. pile external X shared libraries, like Xaw3d. Detailed instructions are
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268. Information for Linux Users
  269.  
  270.  
  271.  
  272. provided in /usr/X11R6/lib/X11/config/lnxLib.rules, where the X library defini-
  273. tions are provided, as an example.
  274.  
  275.  
  276. 9.  Bug Notification
  277.  
  278. Bug reports should be sent to XFree86@XFree86.org or posted to the comp.win-
  279. dows.x.i386unix newsgroup.
  280.  
  281.      Generated from XFree86: xc/programs/Xserver/hw/xfree86/doc/sgml/Linux.sgml,v 3.13.2.3 1997/05/23 12:19:40 dawes Exp $
  282.  
  283.  
  284.  
  285.  
  286.  
  287.      $XConsortium: Linux.sgml /main/6 1996/10/28 04:47:37 kaleb $
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334. Information for Linux Users
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.                    CONTENTS
  405.  
  406.  
  407.  
  408. 1. Linux versions on which XFree86 has been tested  ......................... 1
  409.  
  410. 2. Backwards Compatibility  ................................................. 1
  411.  
  412. 3. Installing XFree86  ...................................................... 1
  413.  
  414. 4. Running XFree86  ......................................................... 1
  415.  
  416. 5. Installing Xdm, the display manager ...................................... 3
  417.  
  418. 6. xterm .................................................................... 3
  419.  
  420. 7. Input devices ............................................................ 3
  421.    7.1 Configuring PEX, XIE and GLX extensions .............................. 4
  422.  
  423. 8. Compiling XFree86  ....................................................... 4
  424.  
  425. 9. Bug Notification  ........................................................ 5
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.                        i
  461.  
  462.  
  463.